Mention that gdk_window_create_similar_image_surface inherits the scale

https://bugzilla.gnome.org/show_bug.cgi?id=776132

diff --git a/gdk/gdkwindow.c b/gdk/gdkwindow.c
index 8c72268711917efd0d2a46b601321af42f258650..6e77e4e60696d05e0679d6e0538f139d78f0f6f4 100644 (file)
--- a/gdk/gdkwindow.c
+++ b/gdk/gdkwindow.c
@@ -7743,6 +7743,10 @@ gdk_window_create_similar_surface (GdkWindow *     window,
  *                                              scale);
  * ]|
  *
+ * Note that unlike cairo_surface_create_similar_image(), the new
+ * surface's device scale is set to @scale, or to the scale factor of
+ * @window if @scale is 0.
+ *
  * Returns: a pointer to the newly allocated surface. The caller
  * owns the surface and should call cairo_surface_destroy() when done
  * with it.